ライン
折れ線グラフは、データ ポイントを直線上にプロットする方法です。多くの場合、傾向データ、または 2 つのデータセットの比較を表示するために使用されます。
使用例
var myLineChart = new Chart(ctx, {
type: 'line',
data: data,
options: options
});
データセットのプロパティ
折れ線グラフを使用すると、データセットごとにいくつかのプロパティを指定できます。これらは、特定のデータセットの表示プロパティを設定するために使用されます。たとえば、線の色は一般的にこのように設定されます。
名前 | タイプ | スクリプト可能 | インデックス可能 | デフォルト |
---|---|---|---|---|
backgroundColor |
Color |
はい | - | 'rgba(0, 0, 0, 0.1)' |
borderCapStyle |
string |
はい | - | 'butt' |
borderColor |
Color |
はい | - | 'rgba(0, 0, 0, 0.1)' |
borderDash |
number[] |
はい | - | [] |
borderDashOffset |
number |
はい | - | 0.0 |
borderJoinStyle |
string |
はい | - | 'miter' |
borderWidth |
number |
はい | - | 3 |
cubicInterpolationMode |
string |
はい | - | 'default' |
clip |
number|object |
- | - | borderWidth / 2 |
fill |
boolean|string |
はい | - | true |
hoverBackgroundColor |
Color |
はい | - | undefined |
hoverBorderCapStyle |
string |
はい | - | undefined |
hoverBorderColor |
Color |
はい | - | undefined |
hoverBorderDash |
number[] |
はい | - | undefined |
hoverBorderDashOffset |
number |
はい | - | undefined |
hoverBorderJoinStyle |
string |
はい | - | undefined |
hoverBorderWidth |
number |
はい | - | undefined |
label |
string |
- | - | '' |
lineTension |
number |
- | - | 0.4 |
order |
number |
- | - | 0 |
pointBackgroundColor |
Color |
はい | はい | 'rgba(0, 0, 0, 0.1)' |
pointBorderColor |
Color |
はい | はい | 'rgba(0, 0, 0, 0.1)' |
pointBorderWidth |
number |
はい | はい | 1 |
pointHitRadius |
number |
はい | はい | 1 |
pointHoverBackgroundColor |
Color |
はい | はい | undefined |
pointHoverBorderColor |
Color |
はい | はい | undefined |
pointHoverBorderWidth |
number |
はい | はい | 1 |
pointHoverRadius |
number |
はい | はい | 4 |
pointRadius |
number |
はい | はい | 3 |
pointRotation |
number |
はい | はい | 0 |
pointStyle |
string|Image |
はい | はい | 'circle' |
showLine |
boolean |
- | - | undefined |
spanGaps |
boolean |
- | - | undefined |
steppedLine |
boolean|string |
- | - | false |
xAxisID |
string |
- | - | 最初の X 軸 |
yAxisID |
string |
- | - | 最初の y 軸 |
全般的
名前 | 説明 |
---|---|
label |
凡例とツールヒントに表示されるデータセットのラベル。 |
order |
データセットの描画順序。積み重ね、ツールチップ、凡例の順序にも影響します。 |
xAxisID |
このデータセットをプロットする X 軸の ID。 |
yAxisID |
このデータセットをプロットする y 軸の ID。 |
ポイントスタイリング
各ポイントのスタイルは、次のプロパティで制御できます。
名前 | 説明 |
---|---|
pointBackgroundColor |
ポイントの塗りつぶしの色。 |
pointBorderColor |
ポイントの境界線の色。 |
pointBorderWidth |
ポイントの境界線の幅 (ピクセル単位)。 |
pointHitRadius |
マウス イベントに反応する非表示ポイントのピクセル サイズ。 |
pointRadius |
ポイントシェイプの半径。 0 に設定すると、ポイントはレンダリングされません。 |
pointRotation |
点の回転 (度単位)。 |
pointStyle |
ポイントのスタイル。もっと... |
これらすべての値がundefined
、最初にデータセット オプションにフォールバックし、次に関連するオプションにフォールバックします。elements.point.*
オプション。
ラインのスタイリング
線のスタイルは、次のプロパティで制御できます。
名前 | 説明 |
---|---|
backgroundColor |
線の塗りつぶしの色。 |
borderCapStyle |
ラインのキャップスタイル。見るMDN。 |
borderColor |
線の色です。 |
borderDash |
ダッシュの長さと間隔。見るMDN。 |
borderDashOffset |
破線のオフセット。見るMDN。 |
borderJoinStyle |
ラインジョイントスタイル。見るMDN。 |
borderWidth |
線幅 (ピクセル単位)。 |
clip |
chartArea を基準にしてクリップする方法。正の値ではオーバーフローが許可され、負の値では chartArea 内の多くのピクセルがクリップされます。0 = chartArea でクリップします。クリッピングは側面ごとに構成することもできます。clip: {left: 5, top: false, right: -2, bottom: 0} |
fill |
線の下の領域を埋める方法。見る面グラフ。 |
lineTension |
線のベジェ曲線の張力。直線を描画するには 0 に設定します。モノトーン 3 次補間が使用される場合、このオプションは無視されます。 |
showLine |
false の場合、このデータセットに対して線は描画されません。 |
spanGaps |
true の場合、データがないか null のデータを持つ点の間に線が描画されます。 false の場合は、NaN データにより行に切れ目が作成されます。 |
値がundefined
、showLine
とspanGaps
関連するものへのフォールバックチャート構成オプション。残りの値は、関連する値にフォールバックされます。elements.line.*
オプション。
インタラクション
各ポイントとの相互作用は、次のプロパティで制御できます。
名前 | 説明 |
---|---|
pointHoverBackgroundColor |
ホバー時のポイントの背景色。 |
pointHoverBorderColor |
ホバーしたときのポイントの境界線の色。 |
pointHoverBorderWidth |
ホバー時のポイントの境界線の幅。 |
pointHoverRadius |
ホバー時のポイントの半径。 |
三次補間モード
次の補間モードがサポートされています。
'default'
'monotone'
の'default'
アルゴリズムはカスタムの重み付け三次補間を使用し、あらゆる種類のデータセットに対して快適な曲線を生成します。
の'monotone'
アルゴリズムの方が適していますy = f(x)
datasets : 内挿されるデータセットの単調性 (または区分的単調性) を保持し、局所的な極値 (存在する場合) が入力データ点に留まるようにします。
そのまま放置しておくと(undefined
)、グローバルoptions.elements.line.cubicInterpolationMode
プロパティが使用されます。
階段状のライン
次の値がサポートされていますsteppedLine
。
false
: ステップ補間なし (デフォルト)true
: 補間前のステップ (eq.'before'
)'before'
: 補間の前段階'after'
: 補間後のステップ'middle'
: ステップ中間補間
もしsteppedLine
値が false 以外に設定されている場合、lineTension
無視されます。
構成オプション
折れ線グラフは次の構成オプションを定義します。これらのオプションは、グローバル チャート構成オプションとマージされます。Chart.defaults.global
、チャートに渡されるオプションを形成します。
名前 | タイプ | デフォルト | 説明 |
---|---|---|---|
showLines |
boolean |
true |
false の場合、点間の線は描画されません。 |
spanGaps |
boolean |
false |
false の場合、NaN データにより行が中断されます。 |
デフォルトのオプション
作成されたすべての折れ線グラフに構成設定を適用することが一般的です。グローバル折れ線グラフ設定は次の場所に保存されます。Chart.defaults.line
。グローバル オプションを変更すると、変更後に作成されたグラフにのみ影響します。既存のチャートは変更されません。
たとえば、すべての折れ線グラフを次のように設定するには、spanGaps = true
あなたならこうします:
Chart.defaults.line.spanGaps = true;
データ構造
のdata
折れ線グラフのデータセットのプロパティは 2 つの形式で渡すことができます。
番号[]
data: [20, 10]
ときdata
array は数値の配列であり、通常、x 軸はカテゴリー。点は、配列内の位置を使用して軸上に配置されます。カテゴリ軸を使用して折れ線グラフを作成すると、labels
データオブジェクトのプロパティを指定する必要があります。
点[]
data: [{
x: 10,
y: 20
}, {
x: 15,
y: 10
}]
この代替データセットは、次のような疎なデータセットに使用されます。散布図。各データ ポイントは、次の内容を含むオブジェクトを使用して指定されます。x
とy
プロパティ。
積み上げ面グラフ
y 軸の設定を変更して積み上げを有効にすることで、折れ線グラフを積み上げ面グラフに構成できます。積み上げ面グラフを使用すると、1 つのデータ傾向が多数の小さな部分からどのように構成されているかを示すことができます。
var stackedLine = new Chart(ctx, {
type: 'line',
data: data,
options: {
scales: {
yAxes: [{
stacked: true
}]
}
}
});